home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir24 / tn-x1jr2.zip / TN-X1J2.ZIP / README.TXT < prev    next >
Text File  |  1994-03-17  |  10KB  |  236 lines
  1. This  disk  contains  the distribution  version  of  TheNet  X-1J 
  2. release 2.
  3.  
  4. 1. Hardware Requirements
  5.  
  6.      The software runs in a Z80 based TNC2 or similar clone  such 
  7.      as the BSX2. It is installed as described in the  bankswitch 
  8.      mods file, but essentially all it needs is a single piece of 
  9.      wire  from pin 8 of the modem disconnect header to pin 1  of 
  10.      the EPROM.
  11.      
  12.      The  EPROM  needed is a 27512, rather than the  27256  of  a 
  13.      normal TNC2. Pin 1 of the EPROM is bent out from the  socket 
  14.      and connected as described above.
  15.      
  16.      The TNC needs to be set to the higher clock speed of 4.9 MHz 
  17.      as  a  minimum.  Whilst  this  version  of  TheNet  is  more 
  18.      efficient  than  others, it is not sensible to  run  at  the 
  19.      slower speed.
  20.      
  21.      The TNC needs at least 32K bytes of RAM.
  22.      
  23.      The  TNC needs to have DCDB from the SIO/0 connected to  pin 
  24.      23 of the RS232 connector. See the section on RS232 later in 
  25.      this note for more information.
  26.      
  27. 2. Installing over TheNet X previous versions
  28.      
  29.      If  you are replacing a previous ROM with TheNet in  it,  be 
  30.      sure to do a coldstart ( you may need to remove the  battery 
  31.      link to force this ).
  32.      
  33. 3. Files
  34.         
  35.      The files on this disk are :
  36.         
  37.           thenet1.x1j    Part 1 of the code
  38.           thenet2.x1j    part 2 of the code
  39.           readme.*       This file
  40.           configur.*     Installation guide
  41.           userguid.*     A user's guide to the node
  42.           overview.*     The sysop's manual
  43.           quickref.*     A handy quick reference guide
  44.           bankswit.*     Info on the hardware bankswitching
  45.           intro.*        The brief release note
  46.           smeter.*       Details on the Smeter hardware
  47.           devmeter.*     Details on the deviation meter
  48.           patch.exe      A windowing driven patcher
  49.           intel.exe      An Intel hex file dump utility
  50.           intel.c        The source of the above
  51.           motorola.exe   A Motorola S1 type file dumper
  52.           motorola.c     The source of the above
  53.           sethelp.exe    Utility to change the ROM help text 
  54.           sethelp.c      The source of the above
  55.           printpwd.exe   Utility to print a password nicely
  56.           printpwd.c     The source of the above
  57.           smeter.csv     Sample data for smeter calibration
  58.           smeter.ljt     Circuit for an S meter in HP PCL format
  59.           ipxlink.doc    Ideas on node IP addressing
  60.         
  61.      The files denoted '*' are stored in two formats
  62.      
  63.              .TXT ASCII versions of the files
  64.              .DOC Word for Windows 2.0 format
  65.         
  66.      The  files  contain  the same except for  the  DEVMETER  and 
  67.      SMETER,  as the ASCII version does not contain  the  circuit 
  68.      diagrams  or graphs. The smeter circuit diagram is shown  in 
  69.      laserjet  printer  format  (  i.e.  HPPCL  )  in  the   file 
  70.      smeter.ljt. As this is a large file, it has been  compressed 
  71.      into the zip file smeter.zip.
  72.         
  73. 4. Using it with a TCP/IP system
  74.         
  75.      One of the reasons for the inclusion of the IP router was to 
  76.      help  the  development  of  IP  networks.  This  is  in  two 
  77.      different ways :
  78.         
  79.         
  80.      It allows a IP station that does not run 24 hours to run  an 
  81.      IP router for the others in the area without leaving the  PC 
  82.      running,
  83.         
  84.          
  85.      It allows existing nodes to double as IP routers.
  86.         
  87.      In scenario 1, where a station runs a TNC2 clone with a KISS 
  88.      ROM  or  similar, this software may be used instead  of  the 
  89.      KISS  ROM.  It should be configured to run  KISS,  Selective 
  90.      Copy on the RS232 port.
  91.         
  92. 5. The other version
  93.         
  94.      The  version that includes the HIGH and LOW commands is  not 
  95.      included here. It used a form of bankswitching that  clashes 
  96.      with the deviation meter.
  97.         
  98. 6. Problems
  99.         
  100.      A  long standing problem with the software was its  tendency 
  101.      to  crash  on  reset. I think I have now cured  it.  It  was 
  102.      caused by an interaction between the bankswitching logic and 
  103.      the  interrupt routines during reset. It should  not  happen 
  104.      now - tell me if it does - but please be certain that it was 
  105.      not  caused  by some other fault such as  wiring  errors  or 
  106.      installing over a previous version without clearing the  RAM 
  107.      first.  You should still take care to use fast enough  parts 
  108.      for the clock rate.
  109.      
  110.      The biggest problem with TheNet X-1J was that some copies of 
  111.      the  beta  test code are in circulation.  These  leaked  out 
  112.      during testing and when I sent out a message telling  people 
  113.      of  the  things to look for to identify  which  version  you 
  114.      have,  some bright spark deleted the files that  showed  the 
  115.      difference. Oh well. Live and learn.
  116.      
  117.      One  common problem. If your node appears to  'lose'  nodes, 
  118.      look very carefully at the rates of node broadcasts and  the 
  119.      setting  of the algorithm control. The RS232 rate should  be 
  120.      faster than the radio rate or it should be set to zero,  and 
  121.      the  alternative  algorithm should only be  enabled  on  the 
  122.      RS232  port if at all. Try switching it off to see  if  that 
  123.      helps.
  124.      
  125.      The  patcher  has been altered. The code now  comes  as  two 
  126.      parts  and  the patcher patches both at the  same  time.  It 
  127.      needs & expects to be able to access both parts.
  128.         
  129. 7.   RS232 connections
  130.         
  131.      It is important that you understand the RS232 connections.
  132.      
  133.      The  RS232  port will operate in one of two basic  modes,  a 
  134.      dumb terminal mode and a protocol mode. Each of these  modes 
  135.      has two basic types of operation. These are detailed further 
  136.      below.
  137.      
  138.      The  decision  as  to  whether the  node  operates  in  dumb 
  139.      terminal or protocol mode depends on the setting of the DCDB 
  140.      input  of the serial communications chip ( the SIO/0  ).  In 
  141.      TNC2  clones,  this  is the signal on pin 23  of  the  RS232 
  142.      connector, but in most TNCs you will need to either insert a 
  143.      link  or  a piece of wire, as detailed in your  TNC  manual. 
  144.      After  connecting the links if needed, then leaving  pin  23 
  145.      open circuit will cause the TNC to operate in dumb  terminal 
  146.      mode,  and setting it to a negative voltage ( ie  connecting 
  147.      it to pin 10 ) will cause it to operate in protocol mode.
  148.      
  149.      If you use a BSX2 TNC, then you should connect pin 23 to pin 
  150.      7  rather than pin 10 for protocol mode. You will also  need 
  151.      to  insert a link into JMP14 & make sure there is no  jumper 
  152.      in JMP9.
  153.      
  154.      If  you use one of the other common TNC2 clones such as  the 
  155.      PK80,  MFJ1270, TNC-200 etc, then I understand ( but  cannot 
  156.      confirm ) that you will need to connect a wire from JMP9 pin 
  157.      1,2 or 3 - they are all joined on the PCB - to RS232 pin 23.
  158.      
  159.      Incidentally,  don't forget to increase the  watchdog  timer 
  160.      capacitor  to give a 1 minute timeout ( C31 to 47uF in  TNC2 
  161.      clones ).
  162.      
  163.      Finally, the protocol modes are CROSSLINK or KISS,  selected 
  164.      by the firmware, and the dumb terminal modes are STANDARD or 
  165.      MODEM,  again set by firmware. In the MODEM  mode,  hardware 
  166.      handshaking  is used for connect request / disconnect.  This 
  167.      is NOT the usual method of operation. Unless you are certain 
  168.      you understand, DO NOT use this mode !.
  169.      
  170. 8. Introduction to nodes
  171.         
  172.      If you have not used a TNC based node before, the  following 
  173.      notes on the operation of the 'dumb terminal' port may be of 
  174.      use.
  175.      
  176.      When  pin  23  on the RS232 interface is high,  and  with  a 
  177.      terminal  or terminal emulator on the RS232 port,  the  node 
  178.      will  not  appear  to respond to anything. If  you  send  an 
  179.      'escape' character, the node should respond with a '* '.  If 
  180.      it does not, look at the TNC status LED. It should be  dimly 
  181.      lit with a little bit of a flicker. If not, the node is  not 
  182.      operating.  If  it  is, you have an RS232  problem.  If  you 
  183.      receive unsolicited garbage whenever the TNC receives  data, 
  184.      you have pin 23 tied low and you are receiving crosslink  or 
  185.      kiss frames.
  186.      
  187.      If it does respond with a star and a space, you can now type 
  188.      one of 3 characters - C, D or P.
  189.         
  190.              P will display or set the current password.
  191.              D will disconnect you from the node.
  192.              C will connect you to the node.
  193.      
  194.      Try the C command. You should get a 'connected' message. Hit 
  195.      '?'  followed  by  return and you will get  a  list  of  all 
  196.      commands.
  197.      
  198.      Escape  commands  only work on the RS232 port when  in  dumb 
  199.      terminal  mode.  Don't forget to disconnect  from  the  node 
  200.      before you disconnect the terminal. 
  201.         
  202. 9. 'User channel' nodes
  203.         
  204.      To  create  a  'user channel' node ( ie  one  that  supports 
  205.      Net/Rom  protocols  on its RS232 port but not on  its  Radio 
  206.      port ), do the following :
  207.         
  208.        
  209.      * Set  the  radio  port default quality  to  one  less  than 
  210.        minqual
  211.      * Bar  node  broadcasts on the radio port  by  setting  MODE 
  212.        parameter number four to 2
  213.      * Ensure that no manual routes exist in the route table  for 
  214.        port 0.
  215.         
  216. 10. EADG Nodes
  217.         
  218.        If you put a node up in the UK that can be heard from East 
  219.        Anglia, may I encourage you to put the QRA locator in  the 
  220.        Beacon text to enable the G1TLH Beacon analysis program to 
  221.        report accurately on propagation conditions.
  222.         
  223.         
  224. 73's
  225.         
  226. Dave G8KBB @ GB7MXM.#36.GBR.EU
  227. [44.131.16.31] g8kbb@g8kbb.ampr.org
  228.         
  229. 7, Rowanhayes Close
  230. Ipswich
  231. IP2 9SX
  232. England
  233.  
  234. Tel    0473 682266
  235.     +44 473 682266
  236.